PowerTools ActiveReports for .NET 9.0J
画像への描画
PowerTools ActiveReports for .NET 9.0J > ActiveReportsユーザーガイド > 概念 > エクスポート > 描画拡張機能 > 画像への描画
すべて展開すべて展開
すべて折りたたむすべて折りたたむ

レポートは画像ファイルに保存することが可能です。レポートを画像形式でエクスポートするには、ImageRenderingExtensionを使用します。ImageTypeプロパティで、サポートされている6種類の画像形式（BMP、EMF、GIF、JPEG、TIFF、PNG）のいずれかを選択します。

レポートを画像としてエクスポートするには、以下のアセンブリへの参照をプロジェクトに追加します。

メモ： デフォルトとして、ImageRenderingExtensionはレポートの各ページを別々のファイルとして作成し、各ファイル名に image001.PNG、image002.PNG、などのようなインデックスを追加します。ただしRDLレポートの場合は、Pagination プロパティをFalseに設定することにより、レポート全体を１つの画像として描画する事が可能です。

レポートを画像形式でエクスポートする方法の一例を以下に示します。

  1. Visual Studioで新しいWindowsフォームアプリケーションを作成するか、既存のアプリケーションを開きます。
  2. Form.csまたはForm.vbが開いたら、タイトルバーをダブルクリックしてForm_Loadイベントを作成します。
  3. 以下のコードをForm_Loadイベント内に追加します。
Visual Basicコード（Form Loadイベント内に貼り付けます。）
コードのコピー 
' エクスポートするレポートを読み込み、ドキュメントオブジェクトを生成します。
Dim report As New GrapeCity.ActiveReports.PageReport(New System.IO.FileInfo("C:\Sample_PageReport.rdlx"))
Dim reportDocument As New GrapeCity.ActiveReports.Document.PageDocument(report)

' 出力先のディレクトリを作成します。
Dim outputDirectory As New System.IO.DirectoryInfo("C:\MyImage")
outputDirectory.Create()

' エクスポートの各種設定を行います。
Dim imageSetting As New GrapeCity.ActiveReports.Export.Image.Page.Settings()
Dim setting As GrapeCity.ActiveReports.Extensibility.Rendering.ISettings = imageSetting' RenderingExtensionを使用し、レポートをエクスポートします。
Dim imageRenderingExtension As New GrapeCity.ActiveReports.Export.Image.Page.ImageRenderingExtension()Dim outputProvider As New GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider(outputDirectory, System.IO.Path.GetFileNameWithoutExtension(outputDirectory.Name))reportDocument.Render(imageRenderingExtension, outputProvider, imageSetting)
C#コード（Form Loadイベント内に貼り付けます。）
コードのコピー 
// エクスポートするレポートを読み込み、ドキュメントオブジェクトを生成します。
GrapeCity.ActiveReports.PageReport report = new GrapeCity.ActiveReports.PageReport(new System.IO.FileInfo(@"C:\Sample_PageReport.rdlx"));
GrapeCity.ActiveReports.Document.PageDocument reportDocument = new GrapeCity.ActiveReports.Document.PageDocument(report);

// 出力先のディレクトリを作成します。
System.IO.DirectoryInfo outputDirectory = new System.IO.DirectoryInfo(@"C:\MyImage");
outputDirectory.Create();

// エクスポートの各種設定を行います。
GrapeCity.ActiveReports.Export.Image.Page.Settings imageSetting = new GrapeCity.ActiveReports.Export.Image.Page.Settings();
GrapeCity.ActiveReports.Extensibility.Rendering.ISettings setting = imageSetting;// RenderingExtensionを使用し、レポートをエクスポートします。
GrapeCity.ActiveReports.Export.Image.Page.ImageRenderingExtension imageRenderingExtension = new GrapeCity.ActiveReports.Export.Image.Page.ImageRenderingExtension();
GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider outputProvider = new GrapeCity.ActiveReports.Rendering.IO.FileStreamProvider(outputDirectory, System.IO.Path.GetFileNameWithoutExtension(outputDirectory.Name));reportDocument.Render(imageRenderingExtension, outputProvider, imageSetting);

画像描画拡張機能のプロパティ

ActiveReportsには、レポートを画像にどのようにエクスポートするかを制御するオプションが用意されています。

プロパティ 説明
Compression TIFF形式にエクスポートするときに使用する圧縮方式を取得または設定します。
Dither TIFF形式にエクスポートするときに、画像をCCITT3やRleなどの白黒出力形式で保存するときにディザリングするかどうかを指定します。このプロパティは、CompressionプロパティがLzwまたはNone（カラー出力を表します）に設定されている場合には効果がありません。
DpiX レンダリングされる画像の水平解像度を設定します。既定値は96です。
DpiY レンダリングされる画像の垂直解像度を設定します。既定値は96です。
EndPage すべてのページを描画しない場合に、描画する最後のページ番号を設定します。StartPageプロパティが既定値の0に設定されている場合、レポートのすべてのページが描画されるのでご注意ください。EndPageプロパティを使用するためには、StartPageプロパティを0以外の有効な数値に設定する必要があります。
ImageType レポートをレンダリングする画像のタイプを選択します。サポートされているタイプは、BMP、EMF、GIF、JPEG、TIFF、PNGです。
MarginBottom 画像の下余白（インチ単位）を設定します。整数または小数の後に"in"を付けます（たとえば、1インチの場合は"1in"）。既定では、余白は使用されません。レポートの設定は、このプロパティに設定された値によってオーバーライドされます。
MarginLeft 画像の左余白（インチ単位）を設定します。整数または小数の後に"in"を付けます（たとえば、1インチの場合は"1in"）。既定では、余白は使用されません。レポートの設定は、このプロパティに設定された値によってオーバーライドされます。
MarginRight 画像の右余白（インチ単位）を設定します。整数または小数の後に"in"を付けます（たとえば、1インチの場合は"1in"）。既定では、余白は使用されません。レポートの設定は、このプロパティに設定された値によってオーバーライドされます。
MarginTop 画像の上余白（インチ単位）を設定します。整数または小数の後に"in"を付けます（たとえば、1インチの場合は"1in"）。既定では、余白は使用されません。レポートの設定は、このプロパティに設定された値によってオーバーライドされます。
PageHeight 画像の高さ（インチ単位）を設定します。整数または小数の後に"in"を付けます（たとえば、11インチの場合は"11in"）。レポートの設定は、このプロパティに設定された値によってオーバーライドされます。
PageWidth 画像の幅（インチ単位）を設定します。整数または小数の後に"in"を付けます（たとえば、11インチの場合は"11in"）。レポートの設定は、このプロパティに設定された値によってオーバーライドされます。
Pagination RDLレポートの場合、既定ではレポートの各ページは別々の画像としてレンダリングされます。この値をFalseに設定すると、レポート全体が単一の画像としてレンダリングされます。
PrintLayoutMode レポートのページを画像内にどのようにレイアウトするかを選択します。
  • OneLogicalPageOnSinglePhysicalPage
  • TwoLogicalPagesOnSinglePhysicalPage
  • FourLogicalPagesOnSinglePhysicalPage
  • EightLogicalPagesOnSinglePhysicalPage
  • BookletMode（小冊子印刷用にページをレイアウトします）
Quality レポートを画像としてレンダリングする際の品質を取得または設定します。
SizeToFit 既定では、レンダリングされるレポートページは、選択した画像サイズに合わせてサイズ変更されません。この値をTrueに設定すると、レポートページのサイズが変更されます。
Start Page すべてのページをレンダリングしない場合に、レンダリングする最初のページ番号を設定します。既定値の0を設定した場合は、レポートのすべてのページが画像にレンダリングされます。
WatermarkAngle 画像上の透かしテキストの角度を指定します。有効な値の範囲は0〜359で、0は水平（左から右）です。
WatermarkColor 画像上の透かしテキストの色を選択します。透かしの色の既定値はグレーですが、任意のWebカラー、システムカラー、またはカスタムカラーを選択できます。
WatermarkFont 透かしに使用するフォントを有効なSystem.Drawing.Fontに設定します。
WatermarkTitle 画像上の透かしテキストとして使用するテキスト（例: CONFIDENTIAL）を設定します。

対話的な機能

画像としてエクスポートされたレポートは、対話的な機能をサポートしません。エクスポート時に非表示になっていたデータは画像にも表示されません。ドリルダウンレポートのすべてのデータを表示するには、エクスポート前に折りたたまれた項目をすべて展開する必要があります。

関連トピック

概念

エクスポート

 

 

©2003-2015 GrapeCity inc. All rights reserved.